home *** CD-ROM | disk | FTP | other *** search
/ Merciful 1 / Merciful - Disc 1.iso / software / t / tape_worm / tape_worm_fs.txt next >
Text File  |  1995-10-14  |  16KB  |  396 lines
  1.  
  2.                               TAPE WORM-FS
  3.                               USER'S GUIDE
  4.  
  5. INTRODUCTION
  6.  
  7. Congratulations on your purchase of TapeWorm-FS for your Amiga computer!
  8. TapeWorm-FS is fully-functional filesystem for SCSI tape drives.  By
  9. using TapeWorm-FS you may access your tape drive just as you would any
  10. other AmigaDOS volume.  That means that you can get directories, add and
  11. delete files, copy files, and perform all file management operations
  12. as if you were using a floppy or hard disk drive.  Note: Since through
  13. TapeWorm-FS your tape drive functions as a Write Once Read Many (WORM)
  14. drive, all data copied to the drive remains on the tape even if you
  15. delete files.  See the section on Using TapeWorm-FS for more information.
  16.  
  17. System Requirements
  18.  
  19. TapeWorm-FS will work on any Amiga computer (or Video Toaster Workstation)
  20. operating under Workbench 2.x or above with a SCSI tape drive (DAT,
  21. 8mm, or QIC format).  There are no minimum memory requirements.  Drives
  22. that support the SCSI II fast search mode are recommended for superior
  23. performance.
  24.  
  25. Installation
  26.  
  27. The TapeWorm-FS disk is not copy protected in any way so you may
  28. make one archival copy in order to protect your investment.  To install
  29. Tape-Worm-FS onto your hard drive, follow these steps:
  30.  
  31. Step 1: Immediately make a backup copy of your TapeWorm-FS original disk, 
  32.         and store it in a safe place.
  33. Step 2: Insert the copy of the TapeWorm-FS disk into a floppy drive, and 
  34.         open the disk by double-clicking on its icon from Workbench.
  35. Step 3: Once the disk contents are displayed on your screen, you will see
  36.         an icon named "Install TapeWorm-FS".  This is the installation
  37.         program that will place the TapeWorm-FS files into the proper
  38.         locations.  Double click on this icon to execute the installation
  39.         program.
  40. Step 4: The TapeWorm-FS Installation Program window will appear on your
  41.         screen.  You must Set Installation Mode by selecting the 
  42.         Intermediate User or Expert User gadget.  The Expert User mode
  43.         will allow you to control the installation process at every step,
  44.         letting you decide exactly where you wish each file to be 
  45.         installed.  Click on the Proceed With Install gadget to continue
  46.         or the Abort Install gadget to end the process.
  47.  
  48. TapeWorm-FS is now installed on your system.  You must now set your 
  49. system-configuration.  See the section on Configuring TapeWorm-FS.
  50.  
  51. If you do not wish to use the installation program to install TapeWorm-FS,
  52. you may perform a manual installation by following these steps:
  53.  
  54. Step 1a: If your system is operation under AmigaDOS 2.1 or later, copy the
  55.          file 'Tape' from the TapeWorm-FS disk to your system's 
  56.          'Devs:DosDrivers' directory.
  57. Step 1b: If your system is operating under AmigaDOS 2.0, append the
  58.          contents of 'TW.Mountlist' file to your system's 'Devs:MountList'
  59.          file and add the command 'Mount TAPE:' to your system's 
  60.          'S:User-Startup' file.
  61. Step 2:  Copy the file 'TapeWorm-FS' to your system's 'L:' directory.
  62.  
  63. If a previous version of TapeWorm-FS is already installed on your system,
  64. and you wish to update the version you are using, perform these steps:
  65.  
  66. Step 1: Copy the file 'TapeWorm-FS' from the disk to your system's 'L:'
  67.         directory.
  68. Step 2: Copy the TWConfig and TWCtrl files to the directory of your 
  69.         choice.
  70.  
  71. TapeWorm-FS is now installed on your system.  Now you must configure your
  72. drive for operation on your system and set the TapeWorm-FS options.
  73.  
  74. The TapeWorm-FS Utilities
  75. -------------------------
  76.  
  77. TW Config
  78.  
  79. Before you can use TapeWorm-FS, you must properly configure the TW.config
  80. file to reflect your system configuration.  You may do so by using the
  81. TWConfig utility which was placed in the location on your hard drive
  82. that you specified during the installation procedure.
  83.  
  84. Start the TWConfig program from Workbench or CLI, and the TWConfig screen
  85. will appear.  From this screen you will be able to:
  86.  
  87.    Configure Drive
  88.    Set Options
  89.    Format
  90.    Recover
  91.  
  92. Configure Drive
  93.  
  94. Click on the Configure Drive gadget to configure your drive for use
  95. under TapeWorm-FS.
  96.  
  97. Device
  98.  
  99. Under the Device requester, you will be able to select the device driver
  100. for your SCSI controller.  (For example, if your computer is the Amiga
  101. 3000, you would select "scsi.device" for Commodore's SCSI controller.)
  102.  
  103. Unit
  104.  
  105. You must select the Unit number for the SCSI tape device you wish to
  106. use under TapeWorm-FS.
  107.  
  108. Blocksize
  109.  
  110. Specify the block size for your tape drive by clicking on this cycle
  111. gadget.  It is recommended that you leave the blocksize at 512 bytes
  112. for all drives except Exabyte 8mm drives, which should have a blocksize
  113. of 1024 bytes.
  114.  
  115. TapeSize
  116.  
  117. Enter the approximate size of the tape being used in this gadget (this
  118. allows the TapeWorm-FS to calculate percentage of tape full when
  119. displaying information about the tape device).
  120.  
  121. When you have configured the drive, click on Save gadget.  Click on the
  122. Cancel gadget of you do not wish to save the current configuration.
  123.  
  124. Note that most of these options only take effect when TapeWorm-FS is
  125. started.  You must reboot or kill (see the TWControl section) and restart
  126. the filesystem for the changes to take effect.
  127.  
  128. Set Options
  129.  
  130. There are several options you may select for the operation of TapeWorm-FS.
  131. Click on the Set Options gadget on the TWConfig main screen.
  132.  
  133. Buffer Reads
  134.  
  135. Files are copied to your Buffer Path (see the next page for an explanation
  136. of the Buffer Path) when they are opened.  The system then reads from 
  137. the files that are in your Buffer Path.  This feature is only really
  138. useful if the program you are using repeatedly seeks throughout the file.
  139. For example, most 'LHARC' programs seek back and forth when extracting
  140. files.
  141.  
  142. Buffer Writes
  143.  
  144. Files are written to your Buffer Path and copied to tape when the file
  145. is closed.  This is necessary for programs that seek around in a file
  146. as they are writing.  Most programs that write IFF files seek back to the
  147. beginning of the file after they are done writing, so this option is very
  148. useful.  Also, this option allows multiple files to be written to the
  149. tape simultaneously, which is not normally possible, due to the inherent
  150. limitations of tape drives.
  151.  
  152. Keep Directory on Tape
  153.  
  154. If your tape drive supports partitioning, selecting this option will let
  155. TapeWorm-FS keep the directory of the tape on the tape itself.  The
  156. directory will be kept in your directory path only when the tape is in
  157. the drive.  When you have selected this option, you must use the TWControl
  158. program to eject the tape, since TapeWorm-FS needs to update the directory
  159. on the tape to reflect the temporary directory that is on the hard disk.
  160. TapeWorm-FS will lock the tape in the drive (on drives that support this
  161. feature) so that the tape may not be ejected manually.  If your system
  162. crashes or otherwise fails before the temporary directory is written
  163. to the tape, the temporary directory will be updated the next time you
  164. insert the tape.  Unlike the other available options, this option takes
  165. effect when you format a tape and remains in effect for that tape.
  166.  
  167. Existing Files Are Read Only
  168.  
  169. This is the normal mode of operation for TapeWorm-FS.  Files can be read
  170. or overwritten, but they cannot be opened and subsequently written to.
  171. If both the Buffer Reads and Buffer Writes are enabled, you can turn
  172. off this option so that files may be updated in place.
  173.  
  174. Keep '.info' Files With Directory
  175.  
  176. By default, '.info' files are kept on tape just as other files.
  177. However, this results in slow Workbench performance as it must seek
  178. around the tape to load files.  Selecting this option directs 
  179. TapeWorm-FS to keep '.info' files as part of the directory file.
  180.  
  181. Directory Path
  182.  
  183. This is where you specify the location in which you wish TapeWorm-FS
  184. to store the device directories.  The default path is your system's
  185. 'S:' directory.
  186.  
  187. Buffer Path
  188.  
  189. If you have selected Buffer Reads or Buffer Writes, this is the location
  190. in which TapeWorm-FS will maintain the buffer.  The default path is in
  191. your system's RAM device.  The buffer is used to store files for reading
  192. and writing (when Buffer Reads or Buffer Writes is selected) so that
  193. these operations will be performed more quickly than if the reads and
  194. writes were from the tape directly.
  195.  
  196. When you have set the options you desire, click on the Save gadget.
  197. Click on the Cancel gadget if you do not wish to save the current
  198. configuration.
  199.  
  200. Format
  201.  
  202. Before accessing your tape drive through TapeWorm-FS, you must insert
  203. a tape into your drive and format the tape.  Insert the tape you wish
  204. to format into the tape drive.  To format the tape, click on the Format
  205. gadget on the TWConfig main screen.  A requester will appear that asks
  206. you to Enter volume name you wish to give to the tape.  Type the name
  207. into this requester and click on the Continue gadget.  TapeWorm-FS will
  208. now format your tape.  If you wish to exit without formatting a tape,
  209. click on the Abort gadget.
  210.  
  211. WARNING: You must only format the tape before using it for the first
  212. time.  If you format the tape again, any data that may have been
  213. previously written to the tape will be lost.
  214.  
  215. Recover
  216.  
  217. Should your tape directory become unavailable to you.  TapeWorm-FS
  218. allows you to rebuild a directory file from the information on a tape.
  219. Insert the tape for which you wish to have a directory rebuilt, then
  220. click on this gadget on the TWConfig main screen.
  221.  
  222. TWCtrol
  223.  
  224. The TWCtrl utility has the following four options (they can also be
  225. invoked from the CLI using the template "TWCtrl <command>):
  226.  
  227.    Inhibit
  228.    Un-Inhibit
  229.    Kill
  230.    Eject
  231.  
  232. Inhibit
  233.  
  234. Selecting this option prevents the filesystem from accessing the tape
  235. drive.  This allows you to make use of other programs that access the
  236. tape drive, such as backup utilities (i.e., Ami-Back).
  237.  
  238. Un-Inhibit
  239.  
  240. Selecting this option allows the filesystem to access the tape drive
  241. after it has been inhibited.
  242.  
  243. Kill
  244.  
  245. This option causes the filesystem to exit.  This is useful if you want
  246. the filesystem to be restarted in order to load a new configuration
  247. or if you are done using the current configuration.  This will only
  248. take affect if there are no outstanding locks on the filesystem
  249. (e.g., there are no assigns to the filesystem, you aren't CD'd to it,
  250. and there is no volume in the drive).
  251.  
  252. Eject
  253.  
  254. The option causes the tape in the drive to be ejected (on drives that
  255. support eject).  If the tape was formatted with the "Keep Directory
  256. on Tape" option, the directory on the tape will be updated.
  257.  
  258. Using TapeWorm-FS
  259.  
  260. TapeWorm-FS allows you to access files on your tape device in the same
  261. way as you would any other AmigaDOS device.  The commands such as
  262. dir, copy, list, delete, etc. work transparently on a device accessed 
  263. through TapeWorm-FS.  However, since data cannot actually be deleted
  264. from within a tape (data can only be appended to a tape without writing
  265. over the existing data), TapeWorm-FS causes your tape device to 
  266. function as a Write Once Read Many (WORM) drive.  This means that every
  267. file ever written to the device remains on the device, even if you delete
  268. the file.
  269.  
  270. When you use the delete command on a file that is located on a TapeWorm-
  271. FS device, the directory file that is maintained for the device is
  272. updated so that the filename will no longer appear by using the
  273. standard AmigaDOS and Workbench commands.  However, you can still access
  274. overwritten or deleted files from the CLI by using the special 
  275. character "@" with a directory or filename.
  276.  
  277. Type "file@<number>" to obtain the version <number> of file.  Versions
  278. start at 1 and go up.  The latest version of a file does not have a 
  279. version number.
  280.  
  281. Type "dir@" in order to have deleted or overwritten files show up in
  282. the directory listing using the "file@<number>" notation.
  283.  
  284. Type "dir@<date>" in order to display only files less than or equal
  285. to <date> in the directory listing.  This also uses the 
  286. "file@<number>" notation.
  287.  
  288. Theory of Operation
  289.  
  290. TapeWorm-FS is an AmigaDOS filesystem handler.  A handler acts as an
  291. interface which allows AmigaDOS to access a piece of hardware.  For
  292. example, 'SER:' allows access to the Amiga's serial port.  A filesystem
  293. handler not only allows access to a storage device, but it maintains
  294. information on the device about files and directories as well.
  295.  
  296. Unlike a hard drive, a streaming tape drive does not allow any arbitrary
  297. block on the tape to be read or written.  Data can only be written by
  298. being appended to the end of the tape.  Also, the tape must be positioned
  299. to read an arbitrary block.  Positioning the tape requires much more
  300. than the corresponding hard disk operation.
  301.  
  302. Due to these limitations, TapeWorm-FS does not keep directory and file
  303. information on the tape itself as FastFileSystem or other hard disk
  304. filesystems would.  TapeWorm-FS maintains the directory information
  305. in a file on your hard disk, and it uses the tape only for storing
  306. the actual file data (as well as recovery information).
  307.  
  308. Performance
  309.  
  310. Once your directory files become large you will notice a slow-down
  311. when performing directory operations.  This is due to the way AmigaDOS
  312. performs seeks within large files.  We recommend adding buffers (using
  313. the AmigaDOS command AddBuffers) to the drive on which your "Directory
  314. Path" is located.  As a rule of thumb, add one buffer for every 36k in
  315. size of the largest directory file.
  316.  
  317. The Buffer Reads and Buffer Writes options can greatly increase 
  318. performance for programs that seek around in a file, or perform lots
  319. of little reads and writes.  A RAM directory is the best place to set
  320. your Buffer Path except when you have files that are larger than the
  321. amount of free RAM available on your system.
  322.  
  323. Note: The most efficient way to use a tape drive is to read files off
  324. in the same order they were put on.  This eliminates seek time, since
  325. after reading a file the tape is immediately positioned to read the
  326. next file.
  327.  
  328. Appendix I:
  329.  
  330. TW.Config File Format
  331.  
  332. DEVICE = <scsi device name>
  333. UNIT = <scsi unit number>
  334. BLOCKSIZE = <block size in bytes>
  335. TAPESIZE = <size of tape in blocks (=MB*2048 for 512 byte blocks)>
  336. DIRPATH = <path to keep directory files (with trailing '/')>
  337. FASTLOCATE = <TRUE or FALSE, to (use/not use) SCSI2 fast locate command>
  338. DEBUG = <optional debug file name and path>
  339. BUFFPATH = <path to keep temporary files (with trailing '/')>
  340. BUFFERREADS = <TRUE or FALSE, Copy file to BuffPath on open>
  341. BUFFERWRITES = <TRUE or FALSE, Write file to BuffPath, copy on close>
  342. DRIVE = <the manufacture and model of the drive this setup is for>
  343. SUPP_PARTITION = <TRUE or FALSE, Does this drive support partitioning?>
  344. MAXBLOCKSIZE = <Maximum blocksize of this drive>
  345. PARTITION = <TRUE or FALSE, Keep directories on tape>
  346. READONLY = <TRUE or FALSE, Existing files are read only>
  347. INFOWITHDIR = <TRUE or FALSE, ".info" files are kept in directory>
  348. USE24BITDMA =<TRUE or FALSE, Use 24 bit DMA-able memory for buffers>
  349.  
  350. The following is an example TW.Config file:
  351.  
  352. DEVICE = scsi.device
  353. UNIT = 4
  354. BLOCKSIZE = 512
  355. TAPESIZE = 1300
  356. DIRPATH = SYS:S/
  357. FASTLOCATE = TRUE
  358. DEBUG = SYS:debug/
  359. BUFFPATH = RAM:
  360. BUFFERREADS = TRUE
  361. BUFFERWRITES = TRUE
  362. DRIVE = ARCHIVE Python
  363. SUPP_PARTITION = TRUE
  364. MAXBLOCKSIZE = 16777215
  365. PARTITION = TRUE
  366. READONLY = FALSE
  367. INFOWITHDIR = TRUE
  368. USE24BITDMA = FALSE
  369.  
  370. Appendix II:
  371.  
  372. Compatible Tape Drives
  373.  
  374. The following is a partial list of the drives which are compatible
  375. with TapeWorm-FS.
  376.  
  377. Archive Python DAT drive
  378. Archive Sidewinder 250
  379. Archive Viper 2525s
  380. Commodore 3070
  381. Exabyte 8mm
  382. Hewlet Packard DAT drive
  383. Sony DAT drive
  384. Tandberg 3640
  385. Teac MT-2ST
  386. Wangtek 5125
  387. Wangtek 5150es
  388. Wangtek 5525es
  389. Wangtek 6200 DAT
  390. Wangtek SCSI-36
  391. Xybyte 8mm (2.3 gigabytes)
  392.  
  393. If you are able to use TapeWorm-FS successfully with a tape drive not
  394. listed about, please contact us so that we may include the drive name
  395. in the next manual revision.
  396.